home *** CD-ROM | disk | FTP | other *** search
/ Computer Shopper 242 / Issue 242 - April 2008 - DPCS0408DVD.ISO / Software Money Savers / VirtualDub / Source / VirtualDub-1.7.7-src.7z / src / h / vd2 / system / time.h < prev    next >
Encoding:
C/C++ Source or Header  |  2007-09-02  |  3.8 KB  |  97 lines
  1. //    VirtualDub - Video processing and capture application
  2. //    System library component
  3. //    Copyright (C) 1998-2004 Avery Lee, All Rights Reserved.
  4. //
  5. //    Beginning with 1.6.0, the VirtualDub system library is licensed
  6. //    differently than the remainder of VirtualDub.  This particular file is
  7. //    thus licensed as follows (the "zlib" license):
  8. //
  9. //    This software is provided 'as-is', without any express or implied
  10. //    warranty.  In no event will the authors be held liable for any
  11. //    damages arising from the use of this software.
  12. //
  13. //    Permission is granted to anyone to use this software for any purpose,
  14. //    including commercial applications, and to alter it and redistribute it
  15. //    freely, subject to the following restrictions:
  16. //
  17. //    1.    The origin of this software must not be misrepresented; you must
  18. //        not claim that you wrote the original software. If you use this
  19. //        software in a product, an acknowledgment in the product
  20. //        documentation would be appreciated but is not required.
  21. //    2.    Altered source versions must be plainly marked as such, and must
  22. //        not be misrepresented as being the original software.
  23. //    3.    This notice may not be removed or altered from any source
  24. //        distribution.
  25.  
  26. #ifndef f_VD2_SYSTEM_TIME_H
  27. #define f_VD2_SYSTEM_TIME_H
  28.  
  29. #include <vd2/system/vdtypes.h>
  30. #include <vd2/system/atomic.h>
  31. #include <vd2/system/thread.h>
  32.  
  33. // VDGetCurrentTick: Retrieve current process timer, in milliseconds.  Should only
  34. // be used for sparsing updates/checks, and not for precision timing.  Approximate
  35. // resolution is 55ms under Win9x and 10-15ms under WinNT. The advantage of this
  36. // call is that it is usually extremely fast (just reading from the PEB).
  37. uint32 VDGetCurrentTick();
  38.  
  39. // VDGetPreciseTick: Retrieves high-performance timer (QueryPerformanceCounter in
  40. // Win32). This is very precise, often <1us, but often suffers from various bugs.
  41. // that make it undesirable for high-accuracy requirements. On x64 Windows it
  42. // can run at 1/2 speed when CPU throttling is enabled, and on some older buggy
  43. // chipsets it can skip around occasionally.
  44. uint64 VDGetPreciseTick();
  45. uint64 VDGetPreciseTicksPerSecondI();
  46. double VDGetPreciseTicksPerSecond();
  47. double VDGetPreciseSecondsPerTick();
  48.  
  49. // VDGetAccurateTick: Reads a timer with good precision and accuracy, in
  50. // milliseconds. On Win9x, it has 1ms precision; on WinNT, it may have anywhere
  51. // from 1ms to 10-15ms, although 1ms can be forced with timeBeginPeriod().
  52. uint32 VDGetAccurateTick();
  53.  
  54. // VDCallbackTimer is an abstraction of the Windows multimedia timer.  As such, it
  55. // is rather expensive to instantiate, and should only be used for critical timing
  56. // needs... such as multimedia.  Basically, there should only really be one or two
  57. // of these running.  Win32 typically implements these as separate threads
  58. // triggered off a timer, so despite the outdated documentation -- which still hasn't
  59. // been updated from Windows 3.1 -- you can call almost any function from the
  60. // callback.  Execution time in the callback delays other timers, however, so the
  61. // callback should still execute as quickly as possible.
  62.  
  63. class VDINTERFACE IVDTimerCallback {
  64. public:
  65.     virtual void TimerCallback() = 0;
  66. };
  67.  
  68. class VDCallbackTimer : private VDThread {
  69. public:
  70.     VDCallbackTimer();
  71.     ~VDCallbackTimer();
  72.  
  73.     bool Init(IVDTimerCallback *pCB, uint32 period_ms);
  74.     bool Init2(IVDTimerCallback *pCB, uint32 period_100ns);
  75.     void Shutdown();
  76.  
  77.     void SetRateDelta(int delta_100ns);
  78.     void AdjustRate(int adjustment_100ns);
  79.  
  80.     bool IsTimerRunning() const;
  81.  
  82. private:
  83.     void ThreadRun();
  84.  
  85.     IVDTimerCallback *mpCB;
  86.     unsigned        mTimerAccuracy;
  87.     uint32            mTimerPeriod;
  88.     VDAtomicInt        mTimerPeriodDelta;
  89.     VDAtomicInt        mTimerPeriodAdjustment;
  90.  
  91.     VDSignal        msigExit;
  92.  
  93.     volatile bool    mbExit;                // this doesn't really need to be atomic -- think about it
  94. };
  95.  
  96. #endif
  97.